home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1999 #2 / Amiga Plus CD - 1999 - No. 2.iso / System-Boost / Workbench / Archive / ViewDiz / ViewDiz-extras / Docs / Textract.doc < prev    next >
Encoding:
Text File  |  1998-11-09  |  7.6 KB  |  210 lines
  1.                  _____.  __________.  __________. __ _____
  2.                 /     |_/   ___    |_/   ___    | \//    /
  3.                 |     ||     \/    ||     \/    |  /    /
  4.                 |     ||     /     ||     /     | /    /__
  5.                 |____/~|__________/~|__________/~ \___/ \/
  6.                 ------------------------------------------
  7.                       1oo Percent CNet Anscii Design
  8.  
  9.                            Textract v1.o by dRm!
  10.  
  11.  
  12.     - -- 1. Short Description ]----.
  13. - -- --- --------------------------'
  14.  
  15.     Program: Textract v1.o
  16.    Function: Extracts/adds File_ID.diz from/to Textfiles
  17.              Decent replacement for TxtExtract, no trashing of
  18.              Textfiles when adding Diz!
  19.      Author: Dreamer/Abyss/1oo%
  20. Releasedate: Fri 02-Feb-1996 00:00
  21.  
  22.  
  23.  
  24.  
  25.     - -- 2. Copyright and Disclaimer ]----.
  26. - -- --- ---------------------------------'
  27.  
  28. This  package is freely distributable.  That means:  you are allowed to re-
  29. distribute this package, as long as you respect these regulations:
  30.  
  31. a. Everything  in  this package is regarded as freeware, which means
  32.    that  the  author  holds  full copyright, but its free to use for
  33.    you.  But please: 'free' does NOT include any support in any way,
  34.    though I will try to help, provided I got enough spare time...
  35.  
  36. b. This package may be freely distributed via BBSs, InterNet/UseNet,
  37.    software  libraries  such  as  Fred Fish's and Aminet CD-ROM, and
  38.    other  similar  electronic  channels.  Only  the complete package
  39.    without modifications may be redistributed.
  40.  
  41. c. It  IS allowed to include the contents of this package to related
  42.    software  like  BBS-packages  (even  if  they  are commercial) or
  43.    "Dizzers",  provided  that  the  program comes together with this
  44.    documentation  without  any modifications, and sending me a short
  45.    note about it (see end of this doc for e-mail addresses).
  46.  
  47. By  using  this  product, you accept that the author can NOT be held liable
  48. for any damage or loss that might occur through its use or the inability to
  49. use it.  The developer(s) of the software can NOT be held responsible.  Use
  50. entirely at your own risk.
  51.  
  52. (Dunno why I have to write such a monster disclaimer... =)
  53.  
  54.  
  55.  
  56.  
  57.     - -- 3. Introduction ]----.
  58. - -- --- ---------------------'
  59.  
  60. I  suppose  you  know which purpose this program fulfils.  I rather want to
  61. tell  you  something  about  the  motivation of writing a replacement for a
  62. program  which  already  exists  and  is used for quite a long time, namely
  63. TXTextract  by  Spy/Mystic/XDesign.   This program does its job quite well,
  64. until the following occurs:  you want to add a changed (or new) File_ID.diz
  65. to  a textfile  which already contains a description.  In most of the cases
  66. the  file  gets  totally trashed.  And as it seems the author of TXTextract
  67. will  never fix that bug, I wrote this small replacement (in C code), which
  68. is 1oo% compatible regarding the supported functions ('a', 'e', and 'f').
  69.  
  70.  
  71.  
  72.  
  73.     - -- 4.1. Installation ]----.
  74. - -- --- -----------------------'
  75.  
  76. Just  replace your old TxtExtract (sometimes called TxtDescript, too), with
  77. Textract (by renaming or changing your configurations.  I suppose first. =)
  78.  
  79.  
  80.  
  81.  
  82.     - -- 4.2. Usage ]----.
  83. - -- --- ----------------'
  84.  
  85. USAGE : Textract [options] e <diztination> <source>
  86.         for extracting a file-description
  87.  
  88.         Textract [options] f <source> <destination> <description>
  89.         to add a new filedescription from a file
  90.  
  91.         Textract [options] a <description> <source/destination>
  92.         to add a new filedescription from a file
  93.  
  94. *NEW*   Textract [options] d <source> <destination>
  95.         to delete a filedescription in a file
  96.  
  97. *NEW*   Textract [options] k <source/destination>
  98.         to kill a filedescription in a file
  99.  
  100.  
  101. Remark: The  command  'p'  for writing a description directly from stdin is
  102.         not  supported,  as  we think there is no need for it anymore (btw:
  103.         the textfile gets trashed by TxtExtract anyway, if a diz is already
  104.         present).  If  you  are in desperate need of it, mail me, and we'll
  105.         see...
  106.  
  107. Options: -xxx = With  this  option  it  is possible to set the buffer in KB
  108.                 used while extracting or adding. Valid values range from 16
  109.                 to  1024 (1 MB Buffer). The value will be rounded up to the
  110.                 next  multiply  of  16. Default value is 128KB. I think you
  111.                 only  have  to  set this to a lower value if you are really
  112.                 low on memory.
  113.  
  114.                 Additionally,  if  the length of the file is lower than the
  115.                 buffer, only the needed buffers will be allocated.
  116.                 (Example: Buffer at 128K (default), Filelength 48K,
  117.                           => allocated buffer: 64K)
  118.  
  119.           -c   = Strips <CR>'s from descriptions, useful for PC-Textfiles.
  120.  
  121.  
  122.  
  123.  
  124.     - -- 4.3 Known Bugs and strange behavior ]----.
  125. - -- --- -----------------------------------------'
  126.  
  127. There are no known bugs at the moment.
  128.  
  129. Yet  using  the f, a, d or k command with a TxtExtract-trashed textfile can
  130. cause  serious  trouble (or textfiles with a stand-alone @BEGIN_FILE_ID.DIZ
  131. somewhere in the textfile in general).
  132.  
  133. The  following  happens:   if  a textfile gets corrupted by TxtExtract, not
  134. only  parts  of  the  file  vanish  in  NIL:,  but  it  also leaves a stray
  135. @BEGIN_FILE_ID.DIZ  somewhere  in  the  file.   If  you  now  try  to add a
  136. File_ID.diz  to  such  a  file,  the DeleteDiz-Subroutine will be called to
  137. remove  the OLD File_ID.diz first.  This searches the text for the @BEGIN..
  138. marker,  then  deleting  everything until the @END..  marker is found.  Now
  139. imagine  what  happens  to  a  textfile  with  a @BEGIN..  somewhere and NO
  140. correspondig  @END.   Right,  everything  from  the  @BEGIN..   on  will be
  141. deleted.  Just test it with a copy of this text:  Try to delete the FileID.
  142. You  will  see that the text suddenly ends in the middle of this paragraph.
  143. (Most likly it will end with "textfiles with a stand-alone "[EOF] =)
  144.  
  145. Again:   This  behavior  looks strange, but it is NO bug!  Blame TxtExtract
  146. instead.  =)
  147.  
  148. Btw:   Strange  crashes  occured with the statram.device (e.g.  sd0:).  Use
  149. RAM:  instead.
  150.  
  151.  
  152.  
  153.  
  154.     - -- 5. History ]----.
  155. - -- --- ----------------'
  156.  
  157. V1.o  - Initial release.
  158.  
  159.  
  160.  
  161.  
  162.     - -- 6. Escpecially reserved space... ]----.
  163. - -- --- --------------------------------------'
  164.  
  165. ...   for  MXLPRX,  who  found most of the bugs during development, and who
  166. want to especially appear in this doc.  So here u are!  =)
  167.  
  168. ...   and  for  Neurodancer,  who  didn't find any bugs, but gave some good
  169. suggestions  (The  -c  option  was  his  idea).  And for proof-reading this
  170. doc, of course!
  171.  
  172. Thanx mates!
  173.  
  174.  
  175.  
  176.  
  177.     - -- 7. How to get in touch ]----.
  178. - -- --- ----------------------------'
  179.  
  180.          For suggestions, bugreports and smalltalk drop a mail to
  181.  
  182.                      mics@rummelplatz.uni-mannheim.de
  183.                             Fido: 2:2480/520.3
  184.                             Warp: 137:15/301.1
  185.                             Coco:   99:107/1.3
  186.  
  187.                  http://rummelplatz.uni-mannheim.de/~mics
  188.  
  189.  
  190.  
  191.                     For anything regarding 1oo%, mail:
  192.  
  193.                         neurodancer@another.gun.de
  194.                              Fido: 2:2480/520
  195.                              Warp: 137:15/301
  196.                              Coco:   99:107/1
  197.  
  198.  
  199.  
  200.     - -- 8. 1oo% Member/Distribution Sites ]----.
  201. - -- --- ---------------------------------------'
  202.  
  203.     GER: The Ambush, +49-8621-64260, 24h, USR 33.6
  204.     GER: Digital Dungeons, +49-6192-910718, 24h, USR 33.6
  205.     GER: Cafe del Mar, +49-6220-private, 24h, USR 33.6
  206.     GER: Confusion, +49-341-private
  207.     USA: Ill Communication, +1-310-329-2283 & 2591, 24h, USR 33.6
  208.  
  209.     WWW: http://rummelplatz.uni-mannheim.de/~mics/100.html
  210.